• chore(claude): add pkg-pr-new preview deploy lookup instructions #4767 👈 (View in Graphite)
• refactor(pegboard-gateway2): consolidate hibernation in-flight and tunnel flush #4754
• chore(kitchen-sink): configurable endpoint #4766
• refactor(rivetkit-core): rename StopReason to ShutdownKind and kill enum fallthroughs #4765
• chore(envoy-client): log command and event payloads #4751
• fix(rivetkit): minor sleep-cleanup follow-ups #4761
• docs(rivetkit): clean up stale setPreventSleep references in docs and JSDoc #4760
• docs(rivetkit): document keepAwake/waitUntil counter-arm race and surface bridge errors #4759
• test(engine): force overdue branch in alarm-during-sleep test with negative offset #4758
• fix(rivetkit-core): return stopping not starting when sleep/destroy called mid-shutdown #4757
• test(rivetkit): remove sleepWithPreventSleep fixture and tests #4756
• test(engine): add regression test for alarm-during-sleep-transition race #4755
• test(rivetkit-core): cover sleep/destroy guards and prevent_sleep no-op #4750
• docs: add keepAwake vs waitUntil table and internal sleep-sequence invariants #4749
• feat(rivetkit): expose c.keepAwake(promise) through native path #4748
• refactor(rivetkit): deprecate setPreventSleep to no-op in TypeScript #4747
• fix(rivetkit-core): enumerate non-drained counters in grace deadline warn log #4746
• fix(rivetkit-core): abort graceful cleanup task when grace deadline elapses #4745
• fix(rivetkit-core): error on sleep/destroy before startup or already-requested #4743
• fix(rivetkit-core): cap SerializeState shutdown timeout at 15s #4742
• refactor(rivetkit-core): remove prevent_sleep field and deprecate set_prevent_sleep to no-op #4741
• fix(api-public): remove orphan import_export actors module #4764
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

Code Review

Overview

This is a minimal documentation-only change that adds a one-line instruction to CLAUDE.md explaining how to find the preview deploy for a PR using the pkg-pr-new bot.

Analysis

What it does:

• Adds a single bullet point under the Git + PRs section of CLAUDE.md
• Explains the correct workflow for locating pkg-pr-new preview deploys, including:
  • How to read the bot comment via GitHub API
  • How to find the Publish check URL
  • Two important gotchas to avoid

Code Quality / Style:

• Follows CLAUDE.md conventions — single bullet point, concise instruction, no paragraphs. ✓
• Placed logically under the Git + PRs section where it's contextually relevant. ✓
• Uses exact gh CLI commands, making it actionable rather than vague. ✓

Content Accuracy:

The two gotchas captured are well-reasoned and worth documenting:

1. pkg-pr-new tags its synthesized merge commit, not the branch tip — this is a real footgun that would cause version mismatches if naively using gh pr view head SHA.
2. Only changed workspaces are published — transitive @rivetkit/* dependencies may be missing, which is critical context for anyone using preview deploys to test inter-package behavior.

Minor Suggestions:

• The jq filter uses test("github-actions"; "i") — this works but may match unrelated GitHub Actions comments if other workflows also post to the PR. A tighter filter (e.g. matching on .body | contains("pkg.pr.new")) would be more precise, but this is a low-risk documentation note, not production code.
• Optionally, "read the pkg-pr-new bot comment" could be clarified to "read the github-actions bot comment left by pkg-pr-new" to make the login filter less surprising to first-time readers.

Summary

Well-targeted, minimal CLAUDE.md addition that captures non-obvious operational knowledge about pkg-pr-new behavior. Follows project conventions and will save future agents/contributors from real confusion. No blocking issues.

Verdict: LGTM with minor optional suggestions.

Preview packages published to npm

Install with:

npm install rivetkit@pr-4767

All packages published as 0.0.0-pr.4767.f478764 with tag pr-4767.

Engine binary is shipped via @rivetkit/engine-cli on linux-x64-musl, linux-arm64-musl, darwin-x64, and darwin-arm64. Windows users should use the release installer or set RIVET_ENGINE_BINARY.

Docker images:

docker pull rivetdev/engine:slim-f478764
docker pull rivetdev/engine:full-f478764

npm install rivetkit@pr-4767
npm install @rivetkit/react@pr-4767
npm install @rivetkit/rivetkit-napi@pr-4767
npm install @rivetkit/workflow-engine@pr-4767